FMS Events Data Group

The "FMS Events" (FmsEvent) data group is used to send event data to the FMS. It gets its data from the "Enron Events" (EnrEvents) support data group.

Events are identified by field device register numbers. A register number may resolve to an FMS item for a specific meter run or for the field device (which includes all of its meter runs). Mapping between event data group elements and FMS occurs within the eventItems section of fmsMaps in the device template file. An ordinal may be specified in the device template file to associate an event with a particular run number.

When an event occurs, data groups in the device template file are searched for a data group element reference to a register. Next, the fmsMaps element of the device template file is searched for an FMS item reference to that data group element. If no FMS item is found, the event is recorded as device specific. Set the omitUnmpappedEvents attribute to true to omit unmapped events from the "FMS Events" data group. See also FMS Event Items.

For more information, see the following subsections:

• Example
• Structure and Components
• To Create a Data Group

For more information about working with device template files, see Device Template Files.

Example

Click here to see an example of the data group   <FmsEvent niceName="FMS Events" baseOrd="1" maxCnt="4" omitUnmappedEvents="false"> <dgElements/> <uccRecvParms> <SDate desc="Start Device Date/Time" required="true"/> <EDate desc="End Device Date/Time" required="true"/> </uccRecvParms> </FmsEvent>

Structure and Components

Click here to see the structure and components of the data group   <!-- By default, registers that are not mapped to FMS configItems are recorded as device-specific events. Set omitUnmappedEvents to true to override this behavior. -->   <FmsEvent niceName="FMS Events" omitUnmappedEvents=""> <dgElements/> <uccRecvParms> <UISParameter/> </uccRecvParms> </FmsEvent>

To Create a Data Group

1. Using a text editor or XML editor, open the device template file to which you want to add data groups.
2. Define a new data group.
   1. Define a dgElements element.
   2. Define a uccRecvParms element in the data group.
   3. Define one or more RecParmName elements.
3. Define any other required data groups.
4. Validate and load your template.